home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / arc / mugcut.readme < prev    next >
Text File  |  1993-02-12  |  10KB  |  130 lines
  1. Short: Joins multiple part uuencoded binaries                                   
  2. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<     
  3. >>>>>>>>>>>>>                                                 <<<<<<<<<<<<<     
  4. >>>>>>>>>>>>>>D o c u m e n t a t i o n   f o r   M U G c u t<<<<<<<<<<<<<<     
  5. >>>>>>>>>>>>>                                                 <<<<<<<<<<<<<     
  6. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<     
  7.                                                                                 
  8.                            (c) 1993 by Mark Rose                                
  9.                                                                                 
  10.                                                                                 
  11. Why MUGcut was written:                                                         
  12. >>>>>>>>>>>>>>>>>>>>>>>                                                         
  13.                                                                                 
  14.   I  download  a  lot of UUEncoded binaries from UseNet.  Most of the files     
  15. there  are in multiple parts.  I tried every UUDecoder and UUJoiner I could     
  16. lay my hands on but to no effect (most of them gave me a "Error in file" or     
  17. something and a special Kick 2.04 UUDecoder crashed on my 2.04 system).  So     
  18. I loaded them in my favorite editor and removed all those useless lines and     
  19. joined  them myself (QUITE a lot of work).  One day it popped into my mind:     
  20. why  not  write a program that removes all that trash and saves me a lot of     
  21. work?                                                                           
  22.                                                                                 
  23.   Please  note  that  this program is not more than a quick attempt to save     
  24. time.   After  some  work it is stable and serves its purpose.  But beware:     
  25. if  you feed weird files (other than .UUEs or .UUEs of a strange format) to     
  26. it I take no responsibility for anything that may happen.                       
  27.                                                                                 
  28.                                                                                 
  29. What MUGcut does:                                                               
  30. >>>>>>>>>>>>>>>>>                                                               
  31.                                                                                 
  32.   It  joins  multiple  part  UUEncoded  binaries (like UseNet articles from     
  33. comp.binaries.amiga,  alt.binaries.pictures,  etc.)  and  removes all lines     
  34. preventing UUDecode from working properly. It is not very fast but short.       
  35.                                                                                 
  36.                                                                                 
  37. Features:                                                                       
  38. >>>>>>>>>                                                                       
  39.                                                                                 
  40.   - Special  Kick  1.2/1.3  and Kick 2.04 version (the 2.04 version being a     
  41.     lot faster and shorter.                                                     
  42.                                                                                 
  43.   - tested  with  more  than 10 MBytes of .UUE files and all of them worked     
  44.     properly.                                                                   
  45.                                                                                 
  46.                                                                                 
  47. Installation:                                                                   
  48. >>>>>>>>>>>>>                                                                   
  49.                                                                                 
  50.   As easy as possible: copy MUGcut somewhere to your path (e.g. C:).            
  51.                                                                                 
  52.                                                                                 
  53. Usage:                                                                          
  54. >>>>>>                                                                          
  55.                                                                                 
  56.   The usage is similar to the Join command:                                     
  57.                                                                                 
  58.     MUGcut file1 file2 [<file3> .. <fileN>] outFile                             
  59.                                                                                 
  60.   Where  file1 - fileN are the .UUE files in correct order and outFile is a     
  61. valid  AmigaDOS  filename.   Please  note that any existing outFile will be     
  62. deleted whether file1 - fileN exist or not.                                     
  63.                                                                                 
  64.   You  get  the  most  out  of  MUGcut if you use it out of Directory Opus,     
  65. DirMaster or similar tool.                                                      
  66.                                                                                 
  67.                                                                                 
  68. Assumptions:                                                                    
  69. >>>>>>>>>>>>                                                                    
  70.                                                                                 
  71.   MUGcut assumes the following things:                                          
  72.                                                                                 
  73.   1. The first file contains a "begin" followed by a three digit number and     
  74.      the  filename  for  UUDecode  and  the  next  line is a valid line for     
  75.      UUDecode.                                                                  
  76.                                                                                 
  77.   2. Every relevant line starts with "M" and is terminated with a ASCII 10.     
  78.                                                                                 
  79.   3. The last file contains an "end"                                            
  80.                                                                                 
  81.   4. Every  line  after  the  "begin"  line  and  before the "end" line not     
  82.      starting  with  "M"  and  followed by a line also starting with "M" is     
  83.      stripped.                                                                  
  84.                                                                                 
  85.   I  suggest you copy a sample to your RamDisk and try MUGcut.  If it works     
  86. for  you (as it does for me):  fine.  Otherwise drop me a line.  If you are     
  87. a very cautious person take a look at the source to see what it does...         
  88.                                                                                 
  89.                                                                                 
  90. How to contact me:                                                              
  91. >>>>>>>>>>>>>>>>>>                                                              
  92.                                                                                 
  93.   There are many ways. Here they are in order of preference:                    
  94.                                                                                 
  95.   - Via EMail    : ukkg@ibm3090.rz.uni-karlsruhe.de >InterNet<                  
  96.                                                                                 
  97.                    ukkg@dkauni2.bitnet               >BitNet< same as above     
  98.                                                                                 
  99.                    s_rose@iravcl.ira.uka.de         >InterNet<                  
  100.                                                                                 
  101.   - Snail Mail   : Mark Rose                  Mark Rose                         
  102.                    Waldhornstr. 36, D604      Franz-Volk-Str. 37                
  103.                    7500 Karlsruhe             7600 Offenburg                    
  104.                    GERMANY                    GERMANY                           
  105.                    (during Semester)          (you may always reach me there    
  106.                                                but may take a while...)         
  107.                                                                                 
  108.                                                                                 
  109.                                                                                 
  110.                                                                                 
  111. +-------------------------------------------------------------------------+     
  112. |           T H I S   P R O G R A M   I S   M A I L W A R E  !            |     
  113. +=========================================================================+     
  114. |  Please remember: This program is MailWare.  If you like it and use it  |     
  115. |   on a regular basis, think of the poor student who appreciates small   |     
  116. |       amounts of mail that tell him how great/average/bad/&$§#?!*       |     
  117. |   his program is. So  M A I L  me at once and have a clear conscience   |     
  118. +-------------------------------------------------------------------------+     
  119.                                                                                 
  120.                                                                                 
  121. ___________________________________________________________________________     
  122.  ____   ONLY   ____  _____  ____                                                
  123. | __ ||\    /||_  _|| ____|| __ |  "Harry : What do you recommend for a         
  124. ||__||||\  //|  ||  || ___ ||__||           hangover?                           
  125. | __ |||\\//||  ||  |||___|| __ |   Annie : Teetotaling and prayer.             
  126. ||  |||| \/ || _||_ ||___||||  ||   Cooper: Good answer.                        
  127. ||  ||||    |||____||_____|||  ||   Harry : I'll try some coffee."              
  128.              makes it possible...                                Twin Peaks     
  129. ___________________________________________________________________________     
  130.